home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / dlmsg200.zip / DELMSG.DOC next >
Text File  |  1990-04-19  |  13KB  |  326 lines
  1.  
  2.  
  3.         DELETE MESSAGES: v2.00                            by Stephen de Plater
  4.         April 19, 1990                                 GTPN Net Address: 302/1
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                     DELETE MESSAGES
  13.                                  by Stephen de Plater
  14.                                 GTPN Net Address: 302/1
  15.                               Voice Phone: +61 2 977-3075
  16.                               Data Phone: +61 2 977-2013
  17.  
  18.  
  19.  
  20.  
  21.         ======================================================================
  22.         0.                           REVISION LIST
  23.         ======================================================================
  24.  
  25.         Just to confuse everyone this revision list begins at version 1.20
  26.  
  27.         VERSION:  Release Date:       Comments:
  28.         -------   ------------        --------------------------------------
  29.         1.20      May 25, 1988        Standard  Command Line  Interface Added.
  30.                                       Command  line   parameters  [/D],  [/Q],
  31.                                       [/K], [/A], [/T] [/I] added (see below).
  32.                                       Pathnames  removed,   replaced  by  area
  33.                                       numbers.
  34.  
  35.         1.21      October 6, 1988     Red faces department!  A simple bug fix.
  36.                                       I just can't believe that no-one spotted
  37.                                       it!!  If some of  your listed areas have
  38.                                       not appeared  to  have been  treated  by
  39.                                       delmsg, (especially if the area is found
  40.                                       down the list somewhat), then this fixes
  41.                                       it.
  42.  
  43.         1.30      March 16, 1989      Major overhaul!   Much  of the code  has
  44.                                       been rewritten. The old /Q  parameter is
  45.                                       no  longer  supported  (DELMSG  will  no
  46.                                       longer  send  anyone  mail).  Test  mode
  47.                                       added.
  48.  
  49.         1.31      March 23, 1989      Support for Netmail 200.
  50.  
  51.         2.00      April 19, 1990      Finally, the docs  for the GT15  version
  52.                                       are done!
  53.  
  54.  
  55.                                      >> page 1 <<
  56.  
  57.         DELETE MESSAGES: v2.00                            by Stephen de Plater
  58.         April 19, 1990                                 GTPN Net Address: 302/1
  59.  
  60.  
  61.  
  62.         ======================================================================
  63.         1.                             COPYRIGHT
  64.         ======================================================================
  65.  
  66.         DELMSG is not placed  in the Public Domain. The copyright  is retained
  67.         and the software is provided on licence:
  68.  
  69.         You are free to  use and make  as many copies of  this program as  you
  70.         wish. You may also give it away to anyone who wants it, provided:
  71.  
  72.         1.   No fee is charged.
  73.         2.   This archive is distributed intact.
  74.         3.   You register the package with an OZNET registration centre.
  75.  
  76.  
  77.         ======================================================================
  78.         2.                           REGISTRATION
  79.         ======================================================================
  80.  
  81.         A  new  registration   scheme  now  applies  to  all  OZNET  software.
  82.         Regardless  of any  previous registration,  this program  now requires
  83.         individual installation for each BBS using it.
  84.  
  85.         There  is  still NO  fee  involved  at all.  DO  NOT  send any  money!
  86.         Registration  simply  involves obtaining  from  me  a CRC  code  which
  87.         matches  your BBS  name.   You may  do this  at any  of the  six OZNET
  88.         registration centres:
  89.  
  90.                   Kangaroo Korner          302/001   Stephen de Plater
  91.                   The Black Hole           302/003   Ken Thompson
  92.                   TSUNAMI! Catch the Wave  *TEMPDN   Chet Wilkinson
  93.                   Control Systems          071/001   Ed Cavender
  94.                   Gidget's Domain          081/005   Jack Hazel
  95.                   Fuzzy Logic              050/018   Phill Piddell
  96.  
  97.         If  you are in  the GTPN  nodelist then you  will be able  to register
  98.         direct  online at any of those centres or via mail in the correct form
  99.         to OZRobot at any of those centres.  See the included OZRobot document
  100.         for details.  If  you are not in the  GTPN net you will need  to apply
  101.         via  private  netmail  or message  to  Sysop at  any  of  the centres.
  102.         Whatever  way  you do  it  you  will need  to  supply  the full  (case
  103.         sensitive) name to which you want the program registered.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                                      >> page 2 <<
  110.  
  111.         DELETE MESSAGES: v2.00                            by Stephen de Plater
  112.         April 19, 1990                                 GTPN Net Address: 302/1
  113.  
  114.  
  115.  
  116.         You will  also need to obtain the  OZINSTAL program which performs the
  117.         actual installation.  OZINSTAL  is not included in this  archive.  You
  118.         should look for OZINST11.ZIP.
  119.  
  120.         PLEASE NOTE: This program will run only in test mode (see below) until
  121.         your registration key is installed.
  122.  
  123.  
  124.         ======================================================================
  125.         3.                              PURPOSE
  126.         ======================================================================
  127.  
  128.                          (Or what does this thing do anyway?)
  129.  
  130.         DELMSG is a companion program for GT Power BBS Systems.
  131.  
  132.         It is  designed to automate  the task of deleting  stale messages from
  133.         your message system. It offers a little more flexibility than some  of
  134.         the other tools which accomplish much the same task
  135.  
  136.  
  137.         ======================================================================
  138.         4.                               USAGE
  139.         ======================================================================
  140.  
  141.         To use DELMSG:
  142.  
  143.         1.   Install DELMSG.EXE in your DOS path.
  144.  
  145.         2.   If you wish you may create an ascii file which contains the names
  146.              of the message areas which are to be searched for stale messages.
  147.              The file may have any name at all, but the  default is GTMDIR.BBS
  148.              It must, however, reside in  the GTPATH directory. If no file  is
  149.              given then  GTMDIR.BBS is used--that  is, it will  search through
  150.              ALL  your message areas for  stale messages. If  a file is given,
  151.              then its  format is  exactly the same  as that of  the GTMDIR.BBS
  152.              file.  In fact, the easiest way to create the file you need is to
  153.              copy the GTMDIR.BBS file and edit it down!
  154.  
  155.              On  this  system  DELMSG  runs   five  times  in  the   automatic
  156.              housekeeping  batch file. Once allowing a 30 day period for stale
  157.              mail,  used  for local  mail areas  and  netmail areas.  Once for
  158.              ordinary echomail areas allowing only 14 days (as there is a much
  159.              greater volume  of mail to purge  and I therefore do  not wish to
  160.              keep it  as long. Once for special  echo conferences which I want
  161.  
  162.  
  163.                                      >> page 3 <<
  164.  
  165.         DELETE MESSAGES: v2.00                            by Stephen de Plater
  166.         April 19, 1990                                 GTPN Net Address: 302/1
  167.  
  168.  
  169.  
  170.              to keep  for longer periods. Once for  a couple of extremely high
  171.              traffic conferences (over 100 messages per day) when only a small
  172.              number of  messages can  be kept. And  once for a  "pass through"
  173.              area where messages are only kept for one day.
  174.  
  175.  
  176.         ======================================================================
  177.         5.                             REPORTING
  178.         ======================================================================
  179.  
  180.         The  message to Sysop  generated by earlier  versions of  DELMSG is no
  181.         longer supported.
  182.  
  183.         The screen output may, of course  also be redirected to a file if  you
  184.         need to save the output for examination later on.
  185.  
  186.  
  187.         ======================================================================
  188.         6.                      COMMAND LINE PARAMETERS
  189.         ======================================================================
  190.  
  191.         DELMSG takes six optional command line parameters as follows:
  192.  
  193.         1.   /N   Test mode.   In this  mode, NO messages  will be deleted  at
  194.                   all,  but the program will run and show which messages would
  195.                   have been deleted  were test mode not in force.  You can use
  196.                   this mode to  try the  program and see  what combination  of
  197.                   parameters gives you optimum results for your system.
  198.  
  199.                   NOTE: Until registration is completed, the program will ONLY
  200.                   run in test  mode, whether  or not this  parameter has  been
  201.                   selected.
  202.  
  203.         2.   /A   Use a file  other than the  GTMDIR.BBS for the list  of mail
  204.                   areas  subject  to re-addressing.  The filename  must follow
  205.                   immediately (no spaces) after the /A parameter. i.e.: if you
  206.                   wanted  to use the  file NONECHO.BBS in  place of GTMDIR.BBS
  207.                   (as I do  here) then the parameter would be "/ANONECHO.BBS".
  208.                   In all cases the file must be in the GTPATH directory.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.                                      >> page 4 <<
  218.  
  219.         DELETE MESSAGES: v2.00                            by Stephen de Plater
  220.         April 19, 1990                                 GTPN Net Address: 302/1
  221.  
  222.  
  223.  
  224.         3.   /Dnn Delete all messages older  than nn days. The time  period is
  225.                   measured  from when the message  was first entered, not from
  226.                   the  time  it  arrived  on  your  system.  It  is  therefore
  227.                   possible, with a very short delete time, for a message to be
  228.                   deleted before anyone has  had a chance to see it.  For that
  229.                   reason the  next parameter has been  introduced. The default
  230.                   is 30 days.
  231.  
  232.         4.   /Knn Keep  all messages at least nn days  from the time when they
  233.                   first  arrived on  your system.  Even if  they were  due for
  234.                   deletion according to  the /D parameter above, do not delete
  235.                   them yet. The default is 0 days.
  236.  
  237.         5.   /Tnn Retain a maximum of  nn messages in any area,  regardless of
  238.                   the requirements of the  /D and /K parameters. Messages  are
  239.                   deleted from the front of  the message base, which generally
  240.                   means that older messages  will be discarded first. Messages
  241.                   marked  NOKILL are exempt (unless the  /I parameter has been
  242.                   given,  see below) but even messages retained under the /Knn
  243.                   parameter are subject to deletion here.
  244.  
  245.         6.   /I   Ignore No-Kill  status. By  default, messages marked  NOKILL
  246.                   are exempt from deletion. By including the /I parameter  you
  247.                   can make them fair game like any other message.
  248.  
  249.         Command line  parameters may be given  in either upper or  lower case,
  250.         and in any order.  The command line parameter switch character  may be
  251.         either "/" or "-" (i.e.: "/T" is the same as "-t").
  252.  
  253.         The parameters must not be run together (i.e.: "/d30 /t /aMINE.TXT" is
  254.         fine, but "/d30/t/aMINE.TXT" is wrong!)
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                      >> page 5 <<
  272.  
  273.         DELETE MESSAGES: v2.00                            by Stephen de Plater
  274.         April 19, 1990                                 GTPN Net Address: 302/1
  275.  
  276.  
  277.  
  278.         ======================================================================
  279.         7.                            DISCLAIMER
  280.         ======================================================================
  281.  
  282.         Q:         What kind of guarantee comes with this software?
  283.  
  284.         A:                    *** ABSOLUTELY NONE!!! ***
  285.  
  286.         If you break it you get to keep both pieces.
  287.  
  288.         I take no responsibility  at all for what this software may  do on any
  289.         computer other than my own. If you use it you do so at your  own risk.
  290.         All that I am prepared to say about it is that it works fine here (and
  291.         I can see no good reason  why it should not also work fine  everywhere
  292.         else also -- but ....)
  293.  
  294.         By using this program you accept these conditions.
  295.  
  296.  
  297.         ======================================================================
  298.         8.                              ENJOY!
  299.         ======================================================================
  300.  
  301.         At least, I hope you do!
  302.         Stephen
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                      >> page 6 <<
  326.